Journal d'un Terrien

Web log de Serge Boisse

On line depuis 1992 !

Publicité
Si cette page vous a plu, Copiez son adresse et partagez-la !
http://sboisse.free.fr/trucs et astuces/Obsidian/Astuces/Markdown (tuto).php
Savez-vous quels sont les articles les plus vendus sur Amazon.fr ?
Markdown (tuto)
trucs et astuces > Obsidian > Astuces > Markdown (tuto)

Tutoriel Markdown

Pasted image 20250316111905.png]

Markdown, c'est c'est le format "texte" qui est utilisé pour entrer du texte formatté dans Obsidian., et dans beaucoup d'autres outils d'édition de texte.

(fichiers .md)

Voici donc mes petits trucs sur la syntaxe Markdown :


Références

voir https://help.obsidian.md/How+to/Format+your+notes
et aussi aide: format your notes (lien vers le coffre "Obsidian Help")
ou obsidian Help (idem)

Voir aussi

Formatter le texte

Pour mettre le style de la sélection en gras : **gras**,
en italique : *italique*,
en surbrillance : entourer par des '=='
Rayé : ~~Rayé~~,
en commentaire : %%commentaire%% (invisible)-> , en en code : entourer la sélection par des backslashes (Alt Gr-7)

en citation : commencer la ligne par ">"
Ceci est une autre ligne dans la même citation

Variante (admonition ou "callout") : commencer la premiere ligne par >[!info]
on peut remplacer le mot clé "info" par d'autres types comme "note" :

>[!note]
>bonjour
Note

bonjour

Cliquer le bloc ci dessous.

Listes :

- en liste 
	- sous liste
1. à puce, 
2. deux

produira :

  • en liste
    • sous liste
  1. à puce,
  2. deux

Bloc de code : commencer et terminer par trois backslashes au début d'une ligne. On peut faire suivre la première série de backslashes par un nom de langage comme "js" ou "dataviewjs". ou "python", ou encore "html", etc. Le code sera colorié automatiquement !

if (true) {
	console.log('yes')
}

chercher dans le menu des commandes (CTRL-P).

Maths

Pour les maths genre , cf MathJax

Insérer des cases à cocher

commencer la ligne par - [ ] ou - [x]. ou...

@ Exemple Liste de tâches ou cases à cocher
@ Exemple Liste de tâches ou cases à cocher

Exemples de listes de case à cocher (j'utilise Snippet "checkbox.css") modifié par moi... ça dépend des thèmes. Avec Bluetopaz, pas la peine. Avec Obsidian Nord, Things et défaut, il le faut. Syntaxe : - [x] texte, et remplacer si on veut le caractère "x" par l'un des suivants :

  • espace : à faire [ ]
  • "x" ou "X" : Terminée [x]
  • ">" Décalée [>]
  • "-" Annulée (non tâche) [-]
  • "?" Inconnu [?]
  • "!" A faire et important [!]
  • "y" Yes, OK [y] ou tous caractères hors ceux cités ici
  • "+" Eventuellement
  • """ quote
  • "*" star
  • "<" batterie ?
  • "/" plein ?
  • "d" éclair bas
  • 'b' bannière
  • "c" pouce en bas
  • "f" flame
  • "i" info
  • "k" clef
  • "l" (L minuscule) localisation ici
  • "p" pouce en haut
  • "u" éclair haut
  • "w" gateau ?
  • "I" Lumière
  • "S" $ argent $

Ligne continue : *** au début de la ligne.


les tables

voir ci-dessous Tables

Images

voir Les liens dans Obsidian
Pour insérer une image locale depuis le coffre en donnant un titre, et en la retaillant :

![La violoniste|256](f_100-x-100-cm-carre-d-artistes-100x100-front-0-mod.jpg)
La violoniste

images externes

![![profil]](https://upload.wikimedia.org/wikipedia/commons/thumb/c/c1/Falcon_9_First_Stage_Reusability_Graphic.jpg/1920px-Falcon_9_First_Stage_Reusability_Graphic.jpg)
![profil]

Icônes et émojis:

appuyer sur WIN+; (pour Windows)
cf aussi T_Caractères spéciaux icônes emojis(lien privé)

Images et NAS : attention !

Le truc, c'est que mettre les coffres sur le NAS synology(lien privé) fait qu'on ne voit pas les images (#bug).
Par contre on peut paster des images du NAS dans le coffre local sur PC, et ça, ça marche ! (sauf qu'elles sont copiées dans le répertoire local PiecesJointes )

a2.gif

utiliser imgur.com pour stocker les images (compressées) dans le cloud ? cf https://www.youtube.com/watch?v=-a1vJVy20cQ&t=137s&ab_channel=SantiYounger Je ne suis pas trop pour cette solution.

vidéos

pour insérer des videos youtube on peut utiliser le lien embed (intégrer en français) de la video, comme suit : (il faut laisser une ligne vide après le </iframe>)

<iframe width="560" height="315" src="https://www.youtube.com/embed/eQpeHKxVIxY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

Notes de bas de page

  • [^Ref] et [^Ref]: Footnote text. : Créer une note de bas de page. Chiant parce qu'il faut descendre pour l'éditer. Mais on peut définir le texte de la footnote directement dans la note:
  • ce texte a une explication en bas de page[1] : Créer une note de bas de page en une ligne. En cliquant on descend, en recliquant on revient ici...
  • si on veut que la footnote soit un lien obsidian, il faut mettre... 3 crochets[2]. bien sûr on peut aliaser le lien avec un "|" à la fin, ou un #... ou un ^...

Les liens dans Obsidian
Les liens dans Obsidian

Les liens dans Obsidian

Tous les liens peuvent être in-linés en les préfixant par un point d'exclamation ! cf Lien in-line, ou comment inclure une page dans une autre !

Liens internes au coffre

  • Pour faire un lien vers une note dans le même coffre, of course utiliser la syntaxe [[nom de la note]], Obsidian est fait pour ça !
  • [[Linking Note|Link Name]] : Créer un lien avec un nom personnalisé
  • [[Linking Note#heading]] : Créer un lien vers un heading (quelconque : #, ##... ) d'une autre note

Un truc génial : quand on change le titre d'une note, les liens qui pointent dessus sont automatiquement mis à jour !

Dans une note, penser à cliquer sur l'icone ":" en haut à droite du panneau pour ouvrir le menu et à chercher "copy Obsidian URL". Il y a la même commande dans le file explorer. Pour la page "par où commencer" ça donnera ce lien, obsidian://open?vault=TestLocal&file=PAR%20O%C3%99%20COMMENCER qui s'utilisera ainsi :
ma page de départ

lien vers un tag

Les tags sont des liens ! En cliquant dessus, la liste des pages contenant le tag s'affiche dans le volet de gauche
#astuces

lien vers un header dans la note

en commençant le lien par "#", comme ça :
[[#Liens internes]] Liens internes
ça marche aussi pour des liens vers un header dans une autre note :
[[Markdown (tuto)#Formatter le texte|formatter]] formatter
(ça évite de créer des blocs ! cf. ci-dessous)

lien vers une partie d'une note

On appelle ça des blocs. Pour établir un lien vers un bloc dans un fichier spécifique, tapez d'abord [[nom du fichier pour faire apparaître une liste de fichiers correspondants. Après avoir sélectionné un fichier, tapez ^ et continuez à taper pour rechercher les blocs à lier.

Une fois que vous aurez appuyé sur la touche Entrée, un lien vers ce bloc sera généré pour vous, dans un format similaire à [[filename#^dcf64c]], où dcf64c est l'ID du bloc qui vient d'être généré pour vous.

Si vous n'êtes pas sûr du fichier dans lequel se trouve le bloc, une autre méthode consiste à taper [[^^ et à rechercher les blocs dans tous les fichiers. Cette recherche s'effectue dans tous les blocs de votre coffre, ce qui peut prendre un peu de temps si votre coffre-fort est volumineux.

Mais le plus simple c'est simplement de faire suivre le nom de la note par # puis le nom d'un paragraphe ! [[_Comment utiliser Obsidian#Insérer des Liens dans une note]] _Comment utiliser Obsidian > Insérer des Liens dans une note

images

Attention

Les images sont maintenant "inline", ce qui veut dire qu'il faut les faire précéder et suivre suivre d'un saut de ligne si on veut les voir "seules".
Pour centrer une mage, utiliser ![[imagename | center]] ou ![[imagename | center] | size] (nécessite le snippet center-img.css)

Image interne au coffre

![[1-chronostase 1.jpg|300]]

1-chronostase 1.jpg

image sur le web

![microdaube|center|200](http://sboisse.free.fr/fun/images/no_windows.gif)

microdaube|center`

Image externe avec un lien web externe

[![La terre vue la nuit | 400](https://eoimages.gsfc.nasa.gov/images/imagerecords/55000/55167/earth_lightsx294x196_grid.jpg)](https://eoimages.gsfc.nasa.gov/images/imagerecords/55000/55167/earth_lights_lrg.jpg)

La terre vue la nuit

On peut alors cliquer sur l'image.
Syntaxe: [![nomImg|taille](URLimg)](URLlien)

image interne avec lien web externe

[![[Pasted image 20250401191234.png|center|300]]](<https://amzn.to/4cxAQTv>)
center

Lien vers l'aide Obsidian

Note

Sur mon site web ces liens ne fonctionneront pas si vous n'avez pas Obsidian.

comme ci :
[Obsidian Help](obsidian://open?vault=Obsidian%20Help&file=Start%20here)
Obsidian Help

lien vers la doc d'un plugin

comme ça !
[doc du Dataview](obsidian://show-plugin?id=dataview) doc du Dataview
doc de mon plugin

Ouvrir un lien dans Windows

Dans le "file explorer" en haut à gauche d'Obsidian on peut cliquer droit sur les fichiers et dossiers, et il y a un item "Ouvrir avec l'application par défaut" (pour les fichiers) ou "afficher dans le dossier" (pour les ... dossiers) Pour les fichiers Markdown j'ai paramétré l'ouverture dans Notepad++ des fichiers .md


html

Il est possible d'insérer directement du html dans le markdown obsidian (pas tout ! entre autres les scripts <script> ne marchent pas)
exemple <b>gras</b> donne gras

ou <small>ceci est écrit en petit</small> qui donne ceci est écrit en petit

ou encore &nbsp; pour insérer un blanc insécable, ou &copy; pour ©

ou <span style="color: red;">coucou</span> qui donne coucou

Code

On peut insérer du code
dans des blocs de codes entre trois quotes ```

print("coucou");

Le nom du langage peut être quelconque mais Obsidian colorise la syntaxe pour js et python, et beaucoup autres (mais pas d'exécution possible)
Par contre Obsidian interprète Dataview, Mermaid, et query.
Ce dernier exemple permet d'afficher le résultat d'une recherche'

Query

recherche dans Obsidian
recherche dans Obsidian

Recherche dans Obsidian (privé)

Le code Query recherche dans les notes : On peut utiliser path, tag, line, section, content.

Syntaxe : on peut écrire content: toto ou content("toto") :
exemple : on écrit juste content: voyage dans un bloc de code de type "query"

content: voyage

autre exemple :

[statut]
[tag: obsidian]
_Comment utiliser Obsidian
2
tags: utiliser/app/obsidian obsidian astuces CSS mode_emploi logiciel description apprendre markdown
_Obsidian Plugins 🔌
1
tags: utiliser/app/obsidian mode_emploi logiciel astuces plugin apprendre
_Publier le contenu d'Obsidian sur un site
1
tags: publier obsidian programmation web

Tables

utiliser le clic droit "insert>table"
Sur la première ligne, entrer le titre des colonnes
A partir de la troisième, remplir les valeurs

Bien que ce ne soit pas nécessaire il est préférable de terminer chaque rangée par un "|" pour faciliter l'export du Markdown vers d'autres logiciels.
Noter que La première ligne (ici First header) doit être précédée d'une ligne vide.

Le nombre de '-------' peut être quelconque (au moins 1)
Noter le : à la fin du ----: , il permet de justifier à droite le conten u des cellules (inversement :--- justifie à gauche, mais c'est le comportement par défaut)

On peut mettre des liens Obsidian dans les cellules mais s'ils contienent des pipes '|' il faut les échapper avec '', exemple [[Keyboard shortcuts\|hotkeys]]

exemple :

First Header | Second Header
----| -----:|
Content from cell 1 | Content from cell 2|
Content in the first column | ligne 2 col 2
First Header Second Header
Content from cell 1 Content from cell 2
Content in the first column ligne 2 col 2

Bien sûr Dataview (plugin) permet de faire d'autres tables.

C'est pas du Markdown mais...

Il est possible d'inclure du HTML dans une note Obsidian. Cf HTML dans Obsidian


  1. ceci est une note de bas de page↩︎
  2. liens↩︎
Publicité
Commentaires

Commentaires (0) :

Page :



Ajouter un commentaire (pas besoin de s'enregistrer)

Pseudo :
Message :


image de protection
En cliquant sur le bouton "Envoyer" vous acceptez les conditions suivantes : Ne pas poster de message injurieux, obscène ou contraire à la loi, ni de liens vers de tels sites. Respecter la "netiquette", ne pas usurper le pseudo d'une autre personne, respecter les posts faits par les autres. L'auteur du site se réserve le droit de supprimer un ou plusieurs posts à tout moment. Merci !
Ah oui : le bbcode et le html genre <br>, <a href=...>, <b>b etc. ne fonctionnent pas dans les commentaires. C'est voulu.
< Retour en haut de la page